Métodos

Encendido

Este método permite asociar una función para que se ejecute cuando se reciba un nuevo evento.

Parámetros

Los argumentos que acepta esta función son los siguientes:

Propiedad	Descripción	Tipo de dato de Dato
event	Es un campo obligatorio que contiene el evento al que deseas asociar tu función.	String
Types of Events	message
WidgetEventListener	Es un campo obligatorio que espera una instancia de la clase WidgetEventListener que tiene el método public void run(String data), el cual se ejecutará cada vez que se cree un nuevo evento.	ai.jelou.widget.WidgetEventListener

Tipo de dato de dato
ai.jelou.widget.WidgetEventListener

Ejemplo de uso

widgetService.on("<evento>", new WidgetEventListener() {
    @Override
    public void run(String data) {
        // Aquí va tu código
    }
});

Conectar

Este método permite iniciar una conexión con el servidor para gestionar solicitudes y manejar nuevos eventos entrantes.

Parámetros

Los argumentos que acepta esta función son los siguientes:

• context

  Descripción
  Es un campo obligatorio que espera el contexto en el que la aplicación está ejecutándose.

  Tipo de dato de Dato
  android.content.Context

• userId

  Descripción
  Es un campo que espera el userUniqueId para asociar todas las transacciones y mensajes a este ID.

  Tipo de dato de Dato
  String

Ejemplo de Uso

widgetService.connect(MainActivity.this);

Obtener Mensajes

Devuelve el historial de mensajes de una sala determinada, con un número definido y contados desde un mensaje específico dentro de esa sala.

Parámetros

El argumento de la función getMessages() es un objeto con las siguientes claves:

• roomId
  Es una clave obligatoria con un valor de Tipo de dato "cadena", que corresponde al ID de la sala de la cual se obtendrán los mensajes. El ID de la sala actual es una clave dentro del objeto room de widgetService, y puede accederse de la siguiente manera: widgetService.room.id.
  Tipo de dato de Dato
  String

• limit
  Es una clave opcional con un valor de Tipo de dato "número", que corresponde al número de mensajes que se obtendrán. Si no se establece, la función getMessages tomará el valor predeterminado de 20, por lo que traerá 20 mensajes.
  Tipo de dato de Dato
  int

• id
  Es una clave opcional con un valor de Tipo de dato "cadena" o "número", que corresponde al ID del mensaje a partir del cual se traerán los mensajes determinados por el parámetro "limit". Si no se establece, la función getMessages tomará el valor predeterminado de null, por lo que traerá los últimos mensajes enviados, según el "limit" establecido.
  Tipo de dato de Dato
  String

Ejemplos de uso

Ejemplo #1 // Ejemplo #1

String roomId = widgetService.getRoomId();
widgetInstance.getMessages(roomId);

Ejemplo #2 // Ejemplo #2

String roomId = widgetService.getRoomId();
widgetInstance.getMessages(roomId);

Ejemplo #3 // Ejemplo #3

int limit = 20;
String lastMessageId = "<lastMessageId -> De iteraciones anteriores>";
String roomId = widgetService.getRoomId();
widgetInstance.getMessages(roomId, limit, lastMessageId);